AcquireLinkSource

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODDraft

AcquireLinkSource
The AcquireLinkSource method returns a reference to the link-source object whose data is stored in the specified storage unit.
ODLinkSource AcquireLinkSource (in ODStorageUnitID id);
id
The ID of the storage unit for the target link.
return value
A reference to the specified link-source object.

DISCUSSION
If your part is the source of a link, you can call this method in your part's InitPartFromStorage method to re-create the link-source object from its stored data.
This method increments the reference count of the returned link-source object. When you have finished using that link-source object, you should call its Release method.

EXCEPTIONS

kODErrCannotAcquireLink
The companion link object does not exist and cannot be created.
kODErrIllegalNullIDInput
The id parameter is null.

SEE ALSO
The ODStorageUnitID type (page 903).
The ODDraft::CreateLinkSource method (page 166).
The ODPart::InitPartFromStorage method (page 530).
The ODLinkSource class (page 371).
"Reading Links in InitPartFromStorage" on page 394 in OpenDoc Programmer's Guide.
"Reading Links for Data Transfer" on page 395 in OpenDoc Programmer's Guide.
Table 11-1 on page 466 in OpenDoc Programmer's Guide.